Motivation

When providing overrides for column values in Collection.sample, it would be nice to optionally inline columns of members. What do I mean by that? Imagine that you have two members

class A(dy.Schema):
    x = dy.Int16(primary_key=True)
    y = dy.Int16()

class B(dy.Schema):
    x = dy.Int16(primary_key=True)
    z = dy.Int16()

in a collection

class C(dy.Collection):
    a: dy.LazyFrame[A]
    b: dy.LazyFrame[B]

For sampling you can currently do

C.sample(overrides=[{"a": {"y": 5}}, "b": {"z": 6}}])

However, it would be nice to "inline" the column values since it is clear what member y and z belong to, i.e. do

C.sample(overrides=[{"y": 5, "z": 6}])

This significantly reduces the amount of typing required to use overrides.

Changes

• Introduce a new option inline_for_sampling: bool for the dy.CollectionMember annotation which can be used to inline the columns of a collection member
• Add checks that inlining a collection member is valid (it does not work if either (1) the member is a 1:N relation, i.e. does not share the common primary key, or (2) it isn't clear which member an inlined column value would refer to)